<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
  <link rel="stylesheet" media="screen" type="text/css" href="./style.css" />
  <link rel="stylesheet" media="screen" type="text/css" href="./design.css" />
  <link rel="stylesheet" media="print" type="text/css" href="./print.css" />

  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
</head>
<body>
<div class="dokuwiki export">

<h1 class="sectionedit1"><a name="building_the_geda_gaf_git_repository_version" id="building_the_geda_gaf_git_repository_version">Building the gEDA/gaf git repository version</a></h1>
<div class="level1">

</div>
<!-- EDIT1 SECTION "Building the gEDA/gaf git repository version" [1-60] -->
<h2 class="sectionedit2"><a name="general_instructions" id="general_instructions">General Instructions</a></h2>
<div class="level2">

<p>
To build the git repository version of gEDA/gaf, follow these instructions:
</p>
<ul>
<li class="level1"><div class="li"> Download and install all the following dependencies.  You will probably want to use your distributions package management system (such as apt-get or yum) to install the dependencies.</div>
<ul>
<li class="level2"><div class="li"> A C compiler and C standard library (<a href="http://gcc.gnu.org/" class="urlextern" title="http://gcc.gnu.org/"  rel="nofollow"> GCC </a> and <a href="http://www.gnu.org/software/libc/" class="urlextern" title="http://www.gnu.org/software/libc/"  rel="nofollow"> GNU Libc </a> are recommended)</div>
</li>
<li class="level2"><div class="li"> <a href="http://flex.sourceforge.net/" class="urlextern" title="http://flex.sourceforge.net/"  rel="nofollow"> flex </a> current</div>
</li>
<li class="level2"><div class="li"> <a href="http://www.gnu.org/software/gawk/" class="urlextern" title="http://www.gnu.org/software/gawk/"  rel="nofollow"> GNU awk </a> current</div>
</li>
<li class="level2"><div class="li"> <a href="http://www.gnu.org/software/automake" class="urlextern" title="http://www.gnu.org/software/automake"  rel="nofollow"> automake </a> 1.6.x or later</div>
</li>
<li class="level2"><div class="li"> <a href="http://www.gnu.org/software/autoconf/" class="urlextern" title="http://www.gnu.org/software/autoconf/"  rel="nofollow"> autoconf </a>  2.60 or later</div>
</li>
<li class="level2"><div class="li"> <a href="http://www.gnu.org/software/libtool/" class="urlextern" title="http://www.gnu.org/software/libtool/"  rel="nofollow"> libtool </a> current</div>
</li>
<li class="level2"><div class="li"> <a href="http://www.gnu.org/software/texinfo/" class="urlextern" title="http://www.gnu.org/software/texinfo/"  rel="nofollow"> texinfo </a> current</div>
</li>
<li class="level2"><div class="li"> <a href="http://pkgconfig.freedesktop.org/wiki" class="urlextern" title="http://pkgconfig.freedesktop.org/wiki"  rel="nofollow"> pkg-config </a> current</div>
</li>
<li class="level2"><div class="li"> <a href="http://www.gnu.org/software/gettext/" class="urlextern" title="http://www.gnu.org/software/gettext/"  rel="nofollow"> gettext </a>  0.16 or later</div>
</li>
<li class="level2"><div class="li"> <a href="http://www.gnu.org/software/guile%22" class="urlextern" title="http://www.gnu.org/software/guile&quot;"  rel="nofollow"> guile </a>  1.8.x (1.6.x is no longer supported)</div>
</li>
<li class="level2"><div class="li"> <a href="http://www.gtk.org/" class="urlextern" title="http://www.gtk.org/"  rel="nofollow"> gtk+ </a> 2.10.x or later</div>
</li>
<li class="level2"><div class="li"> <a href="http://www.gnu.org/software/groff/groff.html" class="urlextern" title="http://www.gnu.org/software/groff/groff.html"  rel="nofollow"> groff </a> current</div>
</li>
<li class="level2"><div class="li"> <a href="http://git-scm.com/" class="urlextern" title="http://git-scm.com"  rel="nofollow"> git </a> 1.6.x or later</div>
</li>
<li class="level2"><div class="li"> <a href="http://www.nongnu.org/cvs/" class="urlextern" title="http://www.nongnu.org/cvs/"  rel="nofollow"> cvs </a> current</div>
</li>
<li class="level2"><div class="li"> <a href="http://freedesktop.org/Software/shared-mime-info" class="urlextern" title="http://freedesktop.org/Software/shared-mime-info"  rel="nofollow"> freedesktop.org MIME info database </a> current</div>
</li>
<li class="level2"><div class="li"> <a href="http://www.freedesktop.org/software/desktop-file-utils/releases" class="urlextern" title="http://www.freedesktop.org/software/desktop-file-utils/releases"  rel="nofollow"> freedesktop.org utilities for manipulating .desktop files </a> current</div>
</li>
</ul>
</li>
</ul>
<ul>
<li class="level1"><div class="li"> It is pretty important to have all of the above programs (especially automake, autoconf, libtool, gtk, and guile) installed in the same prefix (like /usr or /usr/local).  If you do not have them all installed in the same prefix, then building and installing gEDA/gaf is much harder.</div>
</li>
</ul>
<ul>
<li class="level1"><div class="li"> Clone the source from the official git repository.  For information on how to do this, read the <a href="geda-scm.html" class="wikilink1" title="geda-scm.html"> gEDA SCM page </a></div>
</li>
</ul>
<ul>
<li class="level1"><div class="li"> Build the software by executing the following commands inside of the newly cloned git repository:<pre class="code">$ ./autogen.sh
$ ./configure --prefix=$HOME/geda
$ make
$ make install</pre>
</div>
</li>
<li class="level1"><div class="li"> If the above commands execute without <strong>any</strong> error messages, then you have successfully built and installed gEDA/gaf.  If you encounter any errors, be sure to read the README and INSTALL files contained within the tarball.</div>
</li>
</ul>
<ul>
<li class="level1"><div class="li"> You can now run the various programs in the gEDA suite.  Please read the toplevel README file which describes what is available.</div>
</li>
</ul>
<ul>
<li class="level1"><div class="li"> gschem is the schematic capture program and can be run by executing: <code>PATH_WHERE_gEDA_GAF_IS_INSTALLED/bin/gschem</code></div>
</li>
</ul>
<ul>
<li class="level1"><div class="li"> It is recommended that you add <code>PATH_WHERE_gEDA_GAF_IS_INSTALLED/bin</code> to your PATH environment variable (typically done by modifying one of the following files: <code>$HOME/.bashrc</code>, <code>$HOME/.bash_profile</code>, or <code>$HOME/.profile</code>).</div>
</li>
</ul>
<ul>
<li class="level1"><div class="li"> It is highly recommended that you read the gEDA documentation at this point.  You can access the gEDA documentation by running gschem and select Help/gEDA Documentation… from the top menu.</div>
</li>
</ul>
<ul>
<li class="level1"><div class="li"> If you want to get gEDA/gaf repository commit log e-mail messages, please subscribe to the geda-cvs mailing list.  Please see the <a href="geda-mailinglists.html" class="wikilink1" title="geda-mailinglists.html"> mailing lists page </a> for info on how to do this.</div>
</li>
</ul>
<ul>
<li class="level1"><div class="li"> For build problems, please be sure to read the <a href="geda-mailinglists.html" class="wikilink1" title="geda-mailinglists.html"> mailing list archives </a> or <a href="http://www.geda-project.org/search.html" class="urlextern" title="http://www.geda-project.org/search.html"  rel="nofollow"> search </a> this site.  Also look at the <a href="start.html" class="wikilink1" title="start.html"> gEDA wiki </a> for more hints.</div>
</li>
</ul>

</div>
<!-- EDIT2 SECTION "General Instructions" [61-3592] -->
<h2 class="sectionedit3"><a name="distro-specific_information" id="distro-specific_information">Distro-specific information</a></h2>
<div class="level2">

</div>
<!-- EDIT3 SECTION "Distro-specific information" [3593-3633] -->
<h3 class="sectionedit4"><a name="debian-based" id="debian-based">Debian-based</a></h3>
<div class="level3">

<p>
This is tested on <a href="http://crunchbanglinux.org/" class="urlextern" title="http://crunchbanglinux.org/"  rel="nofollow">Crunchbang Linux</a> but should work on Debian Wheezy and possibly Ubuntu also.
</p>
<ol>
<li class="level1"><div class="li"> Install the build dependencies for the packaged version of gEDA:<pre class="code">$ sudo apt-get build-dep geda</pre>
</div>
</li>
<li class="level1"><div class="li"> Install the packages that don&#039;t get pulled in by the above command:<pre class="code">$ sudo apt-get install texinfo
$ sudo apt-get install autopoint
$ sudo apt-get install libtool</pre>
</div>
</li>
<li class="level1"><div class="li"> If you want to generate doxygen output, install it and the other prerequisites:<pre class="code">$ sudo apt-get install doxygen
$ sudo apt-get install imagemagick
$ sudo apt-get install graphviz</pre>
</div>
</li>
<li class="level1"><div class="li"> Clone the source from the official git repository.  For information on how to do this, read the <a href="geda-scm.html" class="wikilink1" title="geda-scm.html"> gEDA SCM topic </a>.</div>
</li>
<li class="level1"><div class="li"> From inside the newly cloned repository, build gEDA/gaf:<pre class="code">$ ./autogen.sh
$ ./configure --prefix=$HOME/geda [--enable-doxygen]
$ make
$ make install</pre>
</div>
</li>
</ol>

</div>
<!-- EDIT4 SECTION "Debian-based" [3634-4574] -->
<h3 class="sectionedit5"><a name="macports" id="macports">MacPorts</a></h3>
<div class="level3">

<p>
<a href="http://www.macports.org/" class="urlextern" title="http://www.macports.org/"  rel="nofollow">MacPorts</a> is an open-source community initiative to design an easy-to-use system for compiling, installing, and upgrading open-source software on the Mac <acronym title="Operating System">OS</acronym> X operating system. MacPorts has a packaged installation of gEDA/gaf but occasionally one needs a more up-to-date version (such as that from git). The easiest way to build from git HEAD on MacPorts is to install the packaged version (at time of writing, 1.6.2) as a way of bringing most of the dependencies into the MacPorts tree.
</p>
<ol>
<li class="level1"><div class="li"> <a href="http://www.macports.org/install.php" class="urlextern" title="http://www.macports.org/install.php"  rel="nofollow">Install MacPorts</a>.</div>
</li>
<li class="level1"><div class="li"> Install the MacPorts-packaged version of gEDA/gaf. As a happy side-effect, this brings in most of the build prerequisites. Also install autoconf and automake:<pre class="code">$ sudo port install geda-gaf
$ sudo port install autoconf
$ sudo port install automake</pre>
</div>
</li>
<li class="level1"><div class="li"> If you want to generate doxygen output, install doxygen:<pre class="code">$ sudo port install doxygen</pre>
</div>
</li>
<li class="level1"><div class="li"> Clone the source from the official git repository.  For information on how to do this, read the <a href="geda-scm.html" class="wikilink1" title="geda-scm.html"> gEDA SCM topic </a>.</div>
</li>
<li class="level1"><div class="li"> From inside the newly cloned repository, build gEDA/gaf:<pre class="code">$ ./autogen.sh
$ ./configure --prefix=$HOME/geda --disable-update-xdg-database [--enable-doxygen]
$ make
$ make install</pre>
</div>
</li>
<li class="level1"><div class="li"> If you are running a recent release of <acronym title="Operating System">OS</acronym> X, X server is not included by default so you might need to install <a href="http://xquartz.macosforge.org/landing/" class="urlextern" title="http://xquartz.macosforge.org/landing/"  rel="nofollow">XQuartz</a></div>
</li>
<li class="level1"><div class="li"> To run the software, you need to set an environment variable to allow Guile to load its shared libraries:<pre class="code">$ export LTDL_LIBRARY_PATH=/opt/local/lib
$ gschem</pre>
</div>
</li>
</ol>

</div>
<!-- EDIT5 SECTION "MacPorts" [4575-] --></div>
</body>
</html>
